home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / c-tools / stormc-demo / readme < prev    next >
Encoding:
Text File  |  1996-02-20  |  9.8 KB  |  354 lines
  1. Welcome to the demo of StormC 1.0
  2.  
  3.  
  4. In November 1995 at the COMPUTER 95 we released the first German Preview 
  5. of StormC. The visitors of the exhibition were amazed at the new 
  6. concepts and innovations of StormC.
  7.  
  8. Some impressions of articles of the German press regarding the Preview 
  9. version: (I will try to translate it as close to the original as 
  10. possible)
  11.  
  12. Amiga Plus 1 / 96
  13.  
  14.   New concepts of development and quality assurance... 
  15.   The first remarkable feature is the project management...
  16.  
  17. Amiga magazine 1 / 96
  18.  
  19.   The project management: At last there is a tool that does not feel like a 
  20.   "ball and chain", but is really useful.
  21.  
  22. Amiga Special 2 / 96
  23.  
  24.   A fast compiler, a powerful debugger and a comfortable
  25.   development system are an interesting mixture, if we talk about
  26.   professional software engineering..
  27.  
  28.  
  29. With the enclosed demo you can convince yourself of these statements.
  30.  
  31.  
  32.  
  33. Restraints of the demo:
  34. ================================
  35.  
  36. The enclosed compiler will compile your large sources but he will however 
  37. write a maximum of 10 KB of object code. But you can get the assurance 
  38. that your large projects can be compiled too.
  39.  
  40. The linker can write programs with a maximum of 20 KB of 
  41. size.
  42.  
  43. All parts of StormC can NOT be started from CLI. They can be used only 
  44. with the integrated environment.
  45.  
  46.  
  47. Important:
  48. ===========================
  49.  
  50. This demo is optimised for installation from CD-ROM. If you have copied 
  51. the files to your hard disk already you need not to do the installation. 
  52. You should then enter solely an assign to StormC into the "user-startup",
  53. so the demo programs and the pre-sets of StormC can be used unchanged.
  54.  
  55. Include - Licences:
  56. =================
  57.  
  58. If you have got the demo from a mailbox or from the Aminet, only our 
  59. includes and libraries are included. For programming you will soon 
  60. need the complete system includes of Kickstart/Workbench 3.1.
  61.  
  62. How to get these includes?
  63. -------------------------------
  64.  
  65. 1.
  66. We can send you a demo of StormC with all includes, but you have to 
  67. pay a charge of 20 $ (30 DM). This amount is deducted when you purchase StormC. 
  68. You have to pay in advance.
  69.  
  70. 2.
  71. You will find the complete includes and libraries on the CD 1/96 of 
  72. the German "Amiga Magazin".
  73.  
  74. 3.
  75. If you have got our Preview of StormC you have already got these 
  76. files too.
  77.  
  78. You only have to add the following files:
  79.  
  80. In the includes drawer the directories:
  81.  
  82.   datatypes
  83.   devices
  84.   diskfont
  85.   dos
  86.   exec
  87.   gadgets
  88.   graphics
  89.   hardware
  90.   intuition
  91.   libraries
  92.   prefs
  93.   resources
  94.   rexx
  95.   utility
  96.   workbench
  97.  
  98. In the libs drawer the libraries:
  99.  
  100.   amiga.lib
  101.   small.lib
  102.   debug.lib
  103.   ddebug.lib
  104.  
  105. Please do not use the includes of other compilers or directly these of other
  106. compilers or our Preview. We have altered some of them, so they will only 
  107. work the way we told you.
  108.  
  109.  
  110. Modifications and expansions to the Preview:
  111.  
  112. In General
  113. ----------
  114.  
  115. The complete environment is localised now. The pre-set language is English.
  116.  
  117. Should you use an English Workbench but want to use the German StormC 
  118. you have to rename the locale file 
  119. "StormC:StormSYS/CATALOGE/German/StormCPP.catalog".
  120.  
  121. Starting the program
  122. --------------
  123.  
  124. Contrary to the description in the manual on page 12 the start-up picture 
  125. does not appear if your Workbench screen has less than 64 colours. In 
  126. this case a small window appears and tells you that the system is 
  127. still loading.
  128.  
  129. Project management (StormShell):
  130. -------------------------------
  131.  
  132. You can use multiple selection on "add file(s)".
  133.  
  134. You can drop Workbench icons (Appwindow) into the project windows.
  135.  
  136. The new menu item "add library(s)..." is the same as "add file(s)...". 
  137. The default path of the ASL file requester is set to "#?.lib". 
  138. The only problem is: multiple selections are always alphabetically 
  139. sorted by the ASL requester. The relevant sequence of libraries can 
  140. only be kept if you add one library after the other to your project.
  141.  
  142. If you add a new file an icon will be created too (optional). The icon 
  143. is taken from "ENV:STORMCPP/def_text.suffix". ".suffix" represents the 
  144. suffix of the file name (e.g. c or h). So you can have different icons 
  145. for different kinds of sources.
  146.  
  147. The pre-sets can be saved and loaded by the StormShell.
  148.  
  149. Two new option pages were added to the project defaults. Another for 
  150. the optimiser of the compiler.
  151.  
  152. Nearly every parameter of the shell environment can be
  153. set at the start of a program.
  154.  
  155. The setting for 32 bit correct multiplication has been deleted. The 
  156. compiler now decides automatically which multiplication is required.
  157.  
  158. You can now select small or large code model.
  159.  
  160. Hint: We do not deliver libraries that support small code model with 
  161. the demo. If you select this option your program will not work.
  162.  
  163. "Make" and "Compile" automatically save your sources now.
  164.  
  165. The functions of the icon bar are available by function keys F1 to 
  166. F10 now.
  167.  
  168. The About window and the option windows can be closed with ESC too.
  169.  
  170. The error window is now accessible by keys:
  171. Use "w" toggles warnings on/off.
  172. Use the cursor keys go through the error list.
  173. Use <Alt> + cursor keys to go to the first or last error message.
  174. Use <Return> to indicate the error message in the editor.
  175.  
  176. The project window is completely accessible by keys too.
  177. Use the cursor keys to move the cursor and the contents.
  178. <Alt><up>/<down> jumps to start/end of the entries
  179. <Shift><right>/<left> jumps to the margins
  180. <Return> executes the action
  181. <Alt><Return> the respective alternative
  182. Backspace and/or Delete deletes the entry under the cursor from the 
  183. project.
  184.  
  185. Debugger (StormRUN):
  186. --------------------
  187.  
  188. The debugger demo described in the manual unfortunately only works with 
  189. operating system V39 and higher. If you have V37/38 you should try the 
  190. Gadtools demo.
  191.  
  192. The menu item "save program as..." is not available in the current demo, 
  193. because we are changing some things.
  194.  
  195. The values of simple number types (char - long) can be changed in all 
  196. variable and inspect windows.
  197.  
  198. We added a hex editor.
  199. With the Tab key you can jump between the columns.
  200. Use "Save Settings" to store the layout of the hex editor.
  201.  
  202. The type output has two modes: 
  203. ANSI-C or AMIGA-C (with ULONG, BYTE ...).
  204. The compiler can not save this in its debug information so we use the 
  205. Amiga-C notation (more compact).
  206.  
  207. Resource-Tracking is now implemented.
  208. If you end a program or "Kill" it screens, windows, memory, libraries, 
  209. locks and files that were not closed or released will be shown. A double 
  210. click onto the entry of the list brings you to the according function call. 
  211. The new menu "Debug" got the menu item "Flush Resources"  to release 
  212. these resources.
  213.  
  214. The resource tracking can determine the direct "caller" only. I.e. the 
  215. function which contains jsr d(a6). A stub function for library calls 
  216. prevents the correct  indication of the call. 
  217. So you should avoid stub functions and use "pragma amicall" and 
  218. "tagcall".
  219.  
  220.  
  221. Editor:
  222. =======
  223.  
  224. Dictionary files and manual colouring
  225. ----------------------------------------
  226. Lexikon (0001)
  227. Amiga characters
  228. 0x00ff0000 0xffffffff 2 0
  229. 0
  230. VOID
  231. LONG...
  232.  
  233. Line 1: This line identifies the file as lexicon and carries the 
  234. version number of the lexicon file.
  235.  
  236. Line 2: Comments
  237.  
  238. Line 3: RGB colour foreground and RGB colour background (V39 and higher)
  239.      foreground pen number and background pen number (V37 and V38)
  240. pen number
  241.  
  242. Line 4: Initial letters on/off
  243.  
  244. Line 5 - ...: Contents
  245.  
  246. From operating system V39 and higher RGB colours can be used for the 
  247. lexicon. The first two numbers indicate the  RGB colour for font and 
  248. background colour (24 bit). You can use hex numbers with "0x" as well.
  249.  
  250. If you use Kickstart V37/V38 pen numbers and colour are fixed. You 
  251. should run StormC on a screen with at least 8 colours to get best 
  252. results.
  253.  
  254. Attention:
  255. ----------
  256. As yet there is no error message if you use a non-existing or 
  257. non-proportional font. We recommand to use only fonts with characters 
  258. of the same width. Courier is not such a font. Some characters are 
  259. broader than the width indicated in the font. So there may be some  
  260. strange effects at the margin of the text.
  261.  
  262. Find&Replace are now completely accessible by keys.
  263.  
  264. We integrated a simple print function which prints the whole text.
  265.  
  266.  
  267. Keyboard settings:
  268. -----------------
  269.  
  270. Shift-Cursor Up/Down
  271. Moves the cursor to the first/last line.
  272.  
  273. Shift-Cursor Left/Right
  274. Moves the cursor to the first/last column of the current line.
  275.  
  276. Alt-Cursor Up/Down
  277. Jumps to the beginning/end of the text.
  278.  
  279. Alt-Cursor Left/Right
  280. Moves the cursor to the next word before or to the last behind the 
  281. cursor.
  282.  
  283. Shift-Delete or Shift-Backspace
  284. Deletes the line under the cursor. The line is stored in the clipboard.
  285.  
  286. Alt-Delete
  287. Deletes the line from the cursor position up to the end of the line.
  288.  
  289. Alt-Backspace
  290. Deletes the text between the first column up to the cursor.
  291.  
  292. Help
  293. Sends the word under the cursor to the Hothelp library V3.0 (14. Feb 94).
  294.  
  295.  
  296. MagicMenu and SUN-Mouse-Utilities
  297. ---------------------------------
  298.  
  299. If you use MagicMenu the mouse pointer freezes up to 10 seconds if you 
  300. are pressing the right mouse button over an icon of the icon bar. This 
  301. is because MagicMenu is not very OS compliant.
  302.  
  303. The same problem can appear with other SUN mouse utilities too.
  304.  
  305.  
  306.  
  307. If you have any questions please feel free to contact us:
  308.  
  309.    HAAGE & PARTNER Computer GmbH
  310.    Mainzer Strasse 10 A
  311.    61191 Rosbach
  312.    Germany
  313.  
  314.    Tel: ++49 06007 93 00 50
  315.    Fax: ++49 06007 75 43
  316.  
  317.    Internet: 100654.3133@compuserve.com
  318.    Compuserve: 100654,3133
  319.  
  320.    Please visit our home page to get the newest information on StormC:
  321.  
  322.    http://home.pages.de/~haage
  323.  
  324.  
  325. Now we want to thank our beta testers.
  326.  
  327. Thank you very much:
  328.  
  329.     Dietmar Augustin
  330.     Olaf Barthel
  331.     Michael Bergmann
  332.     Holger Burkarth
  333.     Thomas Bayen
  334.     Bernhard Büchter
  335.     Michael Donner
  336.     Torsten Ebeling
  337.     David Göhler
  338.     Clemens Marschner
  339.     Alexander Pratsch
  340.     Andreas Pfohl
  341.     Constantin Rack
  342.     Michael Rock
  343.     Jürgen Schildmann
  344.     Carsten Schlote
  345.     Stephan Schüerholz
  346. Thomas Wilhelmi
  347.  
  348. Special thanks to Jeroen T. Vermeulen.
  349.  
  350.  
  351. (c) 1995/1996 HAAGE & PARTNER Computer GmbH
  352.  
  353.  
  354.